@abraca/cli 1.6.0 → 1.9.1

package/dist/abracadabra-cli.cjs

@@ -1285,7 +1285,14 @@ function elementTextContent(el) {
 	for (let i = 0; i < el.length; i++) {
 		const child = el.get(i);
 		if (child instanceof yjs.XmlText) parts.push(xmlTextToMarkdown(child));
-		else if (child instanceof yjs.XmlElement) parts.push(elementTextContent(child));
+		else if (child instanceof yjs.XmlElement) {
+			if (child.nodeName === "docLink") {
+				const docId = child.getAttribute("docId");
+				if (docId) parts.push(`[[${docId}]]`);
+				continue;
+			}
+			parts.push(elementTextContent(child));
+		}
 	}
 	return parts.join("");
 }
@@ -1314,7 +1321,9 @@ function serializeElement(el, indent = "") {
 		case "table": return serializeTable(el);
 		case "docEmbed": {
 			const docId = el.getAttribute("docId");
-			return docId ? `![[${docId}]]` : "";
+			if (!docId) return "";
+			const seamlessAttr = el.getAttribute("seamless");
+			return seamlessAttr === true || seamlessAttr === "true" ? `![[${docId}]]{seamless}` : `![[${docId}]]`;
 		}
 		case "svgEmbed": {
 			const svg = el.getAttribute("svg") || "";
@@ -1628,14 +1637,12 @@ function parseInline(text) {
 				text: kbdProps["value"] || "",
 				attrs: { kbd: { value: kbdProps["value"] || "" } }
 			});
-		} else if (match[5] !== void 0) {
-			const docId = match[5];
-			const displayText = match[6] ?? docId;
-			tokens.push({
-				text: displayText,
-				attrs: { link: { href: `/doc/${docId}` } }
-			});
-		} else if (match[7] !== void 0) tokens.push({
+		} else if (match[5] !== void 0) tokens.push({
+			text: "",
+			node: "docLink",
+			nodeAttrs: { docId: match[5] }
+		});
+		else if (match[7] !== void 0) tokens.push({
 			text: match[7],
 			attrs: { strike: true }
 		});
@@ -1662,7 +1669,7 @@ function parseInline(text) {
 		lastIndex = match.index + match[0].length;
 	}
 	if (lastIndex < stripped.length) tokens.push({ text: stripped.slice(lastIndex) });
-	return tokens.filter((t) => t.text.length > 0);
+	return tokens.filter((t) => t.node || t.text.length > 0);
 }
 function parseTableRow(line) {
 	const parts = line.split("|");
@@ -1790,11 +1797,14 @@ function parseBlocks(markdown) {
 			i++;
 			continue;
 		}
-		const docEmbedMatch = line.match(/^!\[\[([^\]|]+?)(?:\|[^\]]*?)?\]\]\s*$/);
+		const docEmbedMatch = line.match(/^!\[\[([^\]|]+?)(?:\|[^\]]*?)?\]\](\{[^}]*\})?\s*$/);
 		if (docEmbedMatch) {
+			const props = parseMdcProps(docEmbedMatch[2]);
+			const seamless = "seamless" in props || props["seamless"] === "true" || /\{[^}]*\bseamless\b[^}]*\}/.test(docEmbedMatch[2] ?? "");
 			blocks.push({
 				type: "docEmbed",
-				docId: docEmbedMatch[1]
+				docId: docEmbedMatch[1],
+				seamless: seamless || void 0
 			});
 			i++;
 			continue;
@@ -2072,13 +2082,22 @@ function parseBlocks(markdown) {
 	return blocks;
 }
 function fillTextInto(el, tokens) {
-	const filtered = tokens.filter((t) => t.text.length > 0);
+	const filtered = tokens.filter((t) => t.node || t.text.length > 0);
 	if (!filtered.length) return;
-	const xtNodes = filtered.map(() => new yjs.XmlText());
-	el.insert(0, xtNodes);
+	const children = filtered.map((tok) => {
+		if (tok.node) {
+			const xe = new yjs.XmlElement(tok.node);
+			if (tok.nodeAttrs) for (const [k, v] of Object.entries(tok.nodeAttrs)) xe.setAttribute(k, v);
+			return xe;
+		}
+		return new yjs.XmlText();
+	});
+	el.insert(0, children);
 	filtered.forEach((tok, i) => {
-		if (tok.attrs) xtNodes[i].insert(0, tok.text, tok.attrs);
-		else xtNodes[i].insert(0, tok.text);
+		if (tok.node) return;
+		const xt = children[i];
+		if (tok.attrs) xt.insert(0, tok.text, tok.attrs);
+		else xt.insert(0, tok.text);
 	});
 }
 function blockElName(b) {
@@ -2325,6 +2344,7 @@ function fillBlock(el, block) {
 			break;
 		case "docEmbed":
 			el.setAttribute("docId", block.docId);
+			if (block.seamless) el.setAttribute("seamless", "true");
 			break;
 		case "svgEmbed":
 			el.setAttribute("svg", block.svg);
@@ -2849,40 +2869,138 @@ registerCommand({
 		if (!raw) return `Document ${docId} not found.`;
 		const entry = toPlain(raw);
 		const metaKeys = new Set([
-			"icon",
 			"color",
+			"icon",
+			"subtitle",
+			"note",
+			"datetimeStart",
+			"datetimeEnd",
+			"allDay",
+			"dateStart",
+			"dateEnd",
+			"timeStart",
+			"timeEnd",
+			"dateTaken",
+			"checked",
 			"priority",
 			"status",
-			"checked",
+			"taskProgress",
 			"rating",
 			"tags",
-			"dateStart",
-			"dateEnd",
-			"datetimeStart",
-			"datetimeEnd",
-			"allDay",
+			"members",
 			"url",
 			"email",
 			"phone",
 			"number",
 			"unit",
-			"subtitle",
-			"note",
-			"taskProgress",
 			"coverUploadId",
+			"coverDocId",
+			"coverMimeType",
 			"geoType",
 			"geoLat",
 			"geoLng",
+			"geoDescription",
 			"deskX",
 			"deskY",
+			"deskZ",
 			"deskMode",
+			"mmX",
+			"mmY",
+			"graphX",
+			"graphY",
+			"graphPinned",
 			"spShape",
-			"spColor",
-			"chartType",
+			"spOpacity",
+			"spX",
+			"spY",
+			"spZ",
+			"spRX",
+			"spRY",
+			"spRZ",
+			"spSX",
+			"spSY",
+			"spSZ",
+			"spModelUploadId",
+			"spModelDocId",
+			"slidesTransition",
+			"fileType",
+			"entry",
+			"bold",
+			"italic",
+			"textColor",
+			"bgColor",
+			"align",
+			"formula",
 			"kanbanColumnWidth",
 			"galleryColumns",
+			"galleryAspect",
+			"galleryCardStyle",
+			"galleryShowLabels",
+			"gallerySortBy",
 			"calendarView",
-			"tableMode"
+			"calendarWeekStart",
+			"calendarShowWeekNumbers",
+			"tableMode",
+			"tableSortKey",
+			"tableSortDir",
+			"timelineZoom",
+			"timelinePixelsPerDay",
+			"timelineCenterDate",
+			"checklistFilter",
+			"checklistSort",
+			"mapShowLabels",
+			"graphSpacing",
+			"graphShowLabels",
+			"graphEdgeThickness",
+			"showRefEdges",
+			"mmSpacing",
+			"spatialGridVisible",
+			"slidesTheme",
+			"chartType",
+			"chartMetric",
+			"chartColorScheme",
+			"chartLimit",
+			"chartShowLegend",
+			"chartShowValues",
+			"sheetsDefaultColWidth",
+			"sheetsDefaultRowHeight",
+			"sheetsShowGridlines",
+			"sheetsFreezeRows",
+			"sheetsFreezeCols",
+			"mediaRepeat",
+			"mediaShuffle"
+		]);
+		const numericKeys = new Set([
+			"priority",
+			"rating",
+			"number",
+			"taskProgress",
+			"geoLat",
+			"geoLng",
+			"deskX",
+			"deskY",
+			"deskZ",
+			"mmX",
+			"mmY",
+			"graphX",
+			"graphY",
+			"spOpacity",
+			"spX",
+			"spY",
+			"spZ",
+			"spRX",
+			"spRY",
+			"spRZ",
+			"spSX",
+			"spSY",
+			"spSZ",
+			"galleryColumns",
+			"chartLimit",
+			"timelinePixelsPerDay",
+			"sheetsDefaultColWidth",
+			"sheetsDefaultRowHeight",
+			"sheetsFreezeRows",
+			"sheetsFreezeCols"
 		]);
 		const updates = {};
 		let hasUpdates = false;
@@ -2890,17 +3008,7 @@ registerCommand({
 			if (value === "null") updates[key] = null;
 			else if (value === "true") updates[key] = true;
 			else if (value === "false") updates[key] = false;
-			else if ([
-				"priority",
-				"rating",
-				"number",
-				"taskProgress",
-				"geoLat",
-				"geoLng",
-				"deskX",
-				"deskY",
-				"galleryColumns"
-			].includes(key)) updates[key] = parseFloat(value);
+			else if (numericKeys.has(key)) updates[key] = parseFloat(value);
 			else if (key === "tags") updates[key] = value.split(",").map((s) => s.trim());
 			else updates[key] = value;
 			hasUpdates = true;
@@ -3210,6 +3318,801 @@ registerCommand({
 	}
 });
 
+//#endregion
+//#region packages/mcp/src/converters/page-types.ts
+const PAGE_TYPES = {
+	doc: {
+		key: "doc",
+		label: "Document",
+		icon: "file-text",
+		description: "Rich text document with real-time collaboration",
+		core: true,
+		supportsChildren: true
+	},
+	kanban: {
+		key: "kanban",
+		label: "Kanban",
+		icon: "kanban",
+		description: "Drag-and-drop task board with columns and cards",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Column",
+		grandchildLabel: "Card",
+		defaultMetaFields: [{
+			type: "select",
+			key: "kanbanColumnWidth",
+			options: [
+				"narrow",
+				"default",
+				"wide"
+			],
+			label: "Column Width"
+		}]
+	},
+	gallery: {
+		key: "gallery",
+		label: "Gallery",
+		icon: "images",
+		description: "Visual grid of items with rich content",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Item",
+		metaSchema: [
+			{
+				type: "location",
+				latKey: "geoLat",
+				lngKey: "geoLng",
+				label: "Location"
+			},
+			{
+				type: "datetime",
+				key: "datetimeStart",
+				label: "Date"
+			},
+			{
+				type: "tags",
+				key: "tags",
+				label: "Tags"
+			},
+			{
+				type: "rating",
+				key: "rating",
+				max: 5,
+				label: "Rating"
+			},
+			{
+				type: "icon",
+				key: "icon",
+				label: "Icon"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#ec4899",
+					"#f97316",
+					"#22c55e",
+					"#3b82f6",
+					"#a855f7"
+				],
+				label: "Color"
+			}
+		],
+		defaultMetaFields: [
+			{
+				type: "number",
+				key: "galleryColumns",
+				min: 1,
+				max: 6,
+				step: 1,
+				label: "Columns"
+			},
+			{
+				type: "select",
+				key: "galleryAspect",
+				options: [
+					"square",
+					"4:3",
+					"3:2",
+					"16:9",
+					"free"
+				],
+				label: "Aspect Ratio"
+			},
+			{
+				type: "select",
+				key: "galleryCardStyle",
+				options: [
+					"default",
+					"compact",
+					"detailed"
+				],
+				label: "Card Style"
+			},
+			{
+				type: "toggle",
+				key: "galleryShowLabels",
+				label: "Show Labels"
+			},
+			{
+				type: "select",
+				key: "gallerySortBy",
+				options: [
+					"manual",
+					"date",
+					"name",
+					"rating"
+				],
+				label: "Sort"
+			}
+		]
+	},
+	table: {
+		key: "table",
+		label: "Table",
+		icon: "table",
+		description: "Collaborative spreadsheet with custom fields",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Column",
+		grandchildLabel: "Row",
+		defaultMetaFields: [{
+			type: "select",
+			key: "tableMode",
+			options: ["hierarchy", "flat"],
+			label: "Mode"
+		}, {
+			type: "select",
+			key: "tableSortDir",
+			options: ["asc", "desc"],
+			label: "Sort Direction"
+		}]
+	},
+	outline: {
+		key: "outline",
+		label: "Outline",
+		icon: "list-tree",
+		description: "Hierarchical outline with keyboard navigation",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Item",
+		defaultDepth: -1
+	},
+	checklist: {
+		key: "checklist",
+		label: "Checklist",
+		icon: "check-square",
+		description: "Collaborative checklist with sub-tasks, drag-and-drop, and due dates",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Task",
+		defaultDepth: -1,
+		metaSchema: [
+			{
+				type: "toggle",
+				key: "checked",
+				label: "Done"
+			},
+			{
+				type: "select",
+				key: "priority",
+				options: [
+					"none",
+					"low",
+					"medium",
+					"high"
+				],
+				label: "Priority"
+			},
+			{
+				type: "date",
+				key: "dateEnd",
+				label: "Due date"
+			}
+		],
+		defaultMetaFields: [{
+			type: "select",
+			key: "checklistFilter",
+			options: [
+				"all",
+				"active",
+				"completed"
+			],
+			label: "Filter"
+		}, {
+			type: "select",
+			key: "checklistSort",
+			options: [
+				"manual",
+				"priority",
+				"due"
+			],
+			label: "Sort"
+		}]
+	},
+	graph: {
+		key: "graph",
+		label: "Graph",
+		icon: "git-fork",
+		description: "Force-directed knowledge graph — full document tree as nodes & edges",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Node",
+		defaultMetaFields: [{
+			type: "toggle",
+			key: "showRefEdges",
+			label: "Show Ref Edges",
+			default: true
+		}]
+	},
+	timeline: {
+		key: "timeline",
+		label: "Timeline",
+		icon: "gantt-chart",
+		description: "Gantt-style project timeline with epics and tasks",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Epic",
+		grandchildLabel: "Task",
+		metaSchema: [
+			{
+				type: "daterange",
+				startKey: "dateStart",
+				endKey: "dateEnd"
+			},
+			{
+				type: "slider",
+				key: "taskProgress",
+				min: 0,
+				max: 100,
+				label: "Progress"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#818cf8",
+					"#f97316",
+					"#22c55e",
+					"#3b82f6",
+					"#a855f7"
+				],
+				label: "Color"
+			}
+		]
+	},
+	calendar: {
+		key: "calendar",
+		label: "Calendar",
+		icon: "calendar",
+		description: "Event calendar with month, week, and day views",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Event",
+		metaSchema: [
+			{
+				type: "datetimerange",
+				startKey: "datetimeStart",
+				endKey: "datetimeEnd",
+				allDayKey: "allDay"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#ec4899",
+					"#f97316",
+					"#22c55e",
+					"#3b82f6",
+					"#a855f7"
+				],
+				label: "Color"
+			},
+			{
+				type: "icon",
+				key: "icon",
+				label: "Icon"
+			}
+		],
+		defaultMetaFields: [
+			{
+				type: "select",
+				key: "calendarWeekStart",
+				options: ["sun", "mon"],
+				label: "Week Starts"
+			},
+			{
+				type: "select",
+				key: "calendarView",
+				options: [
+					"month",
+					"week",
+					"day"
+				],
+				label: "Default View"
+			},
+			{
+				type: "toggle",
+				key: "calendarShowWeekNumbers",
+				label: "Show Week Numbers"
+			}
+		]
+	},
+	map: {
+		key: "map",
+		label: "Map",
+		icon: "map",
+		description: "Collaborative world map with shared markers",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Location",
+		defaultMetaFields: [{
+			type: "toggle",
+			key: "mapShowLabels",
+			label: "Show Labels",
+			default: true
+		}]
+	},
+	dashboard: {
+		key: "dashboard",
+		label: "Dashboard",
+		icon: "layout-dashboard",
+		description: "Arrange documents as draggable icons with optional widget views",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Item"
+	},
+	call: {
+		key: "call",
+		label: "Call",
+		icon: "phone",
+		description: "Video call room with live audio and screen sharing",
+		core: true,
+		supportsChildren: false
+	},
+	chart: {
+		key: "chart",
+		label: "Chart",
+		icon: "bar-chart-3",
+		description: "Charts — manual data points or aggregation over document trees",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Data Point",
+		grandchildLabel: "Data Point",
+		metaSchema: [
+			{
+				type: "number",
+				key: "number",
+				step: .01,
+				label: "Value"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#ec4899",
+					"#f97316",
+					"#22c55e",
+					"#3b82f6",
+					"#a855f7",
+					"#14b8a6",
+					"#eab308"
+				],
+				label: "Color"
+			},
+			{
+				type: "tags",
+				key: "tags",
+				label: "Tags"
+			}
+		],
+		defaultMetaFields: [
+			{
+				type: "select",
+				key: "chartType",
+				options: [
+					"bar",
+					"stacked bar",
+					"line",
+					"donut",
+					"treemap"
+				],
+				label: "Chart Type"
+			},
+			{
+				type: "select",
+				key: "chartMetric",
+				options: [
+					"value",
+					"type",
+					"tag",
+					"status",
+					"priority",
+					"activity",
+					"completion"
+				],
+				label: "Metric"
+			},
+			{
+				type: "select",
+				key: "chartColorScheme",
+				options: [
+					"default",
+					"warm",
+					"cool",
+					"mono"
+				],
+				label: "Colors"
+			},
+			{
+				type: "number",
+				key: "chartLimit",
+				min: 3,
+				max: 30,
+				step: 1,
+				label: "Max Items"
+			},
+			{
+				type: "toggle",
+				key: "chartShowLegend",
+				label: "Show Legend",
+				default: true
+			},
+			{
+				type: "toggle",
+				key: "chartShowValues",
+				label: "Show Values"
+			}
+		]
+	},
+	sheets: {
+		key: "sheets",
+		label: "Sheets",
+		icon: "grid-3x3",
+		description: "Spreadsheet — cells, formulas, and formatting in a collaborative grid",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Column",
+		grandchildLabel: "Cell",
+		defaultMetaFields: [
+			{
+				type: "number",
+				key: "sheetsDefaultColWidth",
+				min: 40,
+				max: 500,
+				step: 10,
+				label: "Column Width"
+			},
+			{
+				type: "number",
+				key: "sheetsDefaultRowHeight",
+				min: 20,
+				max: 100,
+				step: 2,
+				label: "Row Height"
+			},
+			{
+				type: "toggle",
+				key: "sheetsShowGridlines",
+				label: "Gridlines"
+			}
+		]
+	},
+	slides: {
+		key: "slides",
+		label: "Slides",
+		icon: "presentation",
+		description: "Presentation slides with two-axis navigation",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Slide",
+		grandchildLabel: "Sub-slide",
+		metaSchema: [{
+			type: "select",
+			key: "slidesTransition",
+			options: [
+				"none",
+				"fade",
+				"slide"
+			],
+			label: "Transition"
+		}, {
+			type: "colorPreset",
+			key: "color",
+			presets: [
+				"#6366f1",
+				"#ec4899",
+				"#f97316",
+				"#22c55e",
+				"#3b82f6",
+				"#a855f7"
+			],
+			label: "Accent"
+		}],
+		defaultMetaFields: [{
+			type: "select",
+			key: "slidesTheme",
+			options: ["dark", "light"],
+			label: "Theme"
+		}]
+	},
+	overview: {
+		key: "overview",
+		label: "Overview",
+		icon: "radar",
+		description: "Space home — activity, people, stats, and health at a glance",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Page"
+	},
+	spatial: {
+		key: "spatial",
+		label: "Spatial",
+		icon: "box",
+		description: "3D scene with collaborative objects and real-time presence",
+		core: false,
+		plugin: "spatial",
+		supportsChildren: true,
+		childLabel: "Object",
+		grandchildLabel: "Part",
+		defaultDepth: -1,
+		metaSchema: [
+			{
+				type: "select",
+				key: "spShape",
+				options: [
+					"box",
+					"sphere",
+					"cylinder",
+					"cone",
+					"plane",
+					"torus",
+					"glb"
+				],
+				label: "Shape"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#ef4444",
+					"#22c55e",
+					"#3b82f6",
+					"#f97316",
+					"#a855f7",
+					"#ec4899",
+					"#14b8a6"
+				],
+				label: "Color"
+			},
+			{
+				type: "slider",
+				key: "spOpacity",
+				min: 0,
+				max: 100,
+				label: "Opacity"
+			},
+			{
+				type: "number",
+				key: "spX",
+				step: .1,
+				label: "X"
+			},
+			{
+				type: "number",
+				key: "spY",
+				step: .1,
+				label: "Y"
+			},
+			{
+				type: "number",
+				key: "spZ",
+				step: .1,
+				label: "Z"
+			},
+			{
+				type: "number",
+				key: "spRX",
+				min: -180,
+				max: 180,
+				step: 1,
+				label: "Rot X"
+			},
+			{
+				type: "number",
+				key: "spRY",
+				min: -180,
+				max: 180,
+				step: 1,
+				label: "Rot Y"
+			},
+			{
+				type: "number",
+				key: "spRZ",
+				min: -180,
+				max: 180,
+				step: 1,
+				label: "Rot Z"
+			},
+			{
+				type: "number",
+				key: "spSX",
+				min: .01,
+				max: 100,
+				step: .1,
+				label: "Scale X"
+			},
+			{
+				type: "number",
+				key: "spSY",
+				min: .01,
+				max: 100,
+				step: .1,
+				label: "Scale Y"
+			},
+			{
+				type: "number",
+				key: "spSZ",
+				min: .01,
+				max: 100,
+				step: .1,
+				label: "Scale Z"
+			}
+		],
+		defaultMetaFields: [{
+			type: "toggle",
+			key: "spatialGridVisible",
+			label: "Show Grid",
+			default: true
+		}]
+	},
+	media: {
+		key: "media",
+		label: "Media",
+		icon: "disc-3",
+		description: "Media player with synced listening and playlists",
+		core: false,
+		plugin: "media",
+		supportsChildren: true,
+		childLabel: "Track",
+		defaultDepth: -1,
+		metaSchema: [{
+			type: "tags",
+			key: "tags",
+			label: "Tags"
+		}],
+		defaultMetaFields: [{
+			type: "select",
+			key: "mediaRepeat",
+			options: [
+				"off",
+				"all",
+				"one"
+			],
+			label: "Repeat"
+		}, {
+			type: "toggle",
+			key: "mediaShuffle",
+			label: "Shuffle"
+		}]
+	},
+	coder: {
+		key: "coder",
+		label: "Coder",
+		icon: "code-2",
+		description: "Collaborative multi-file coding environment",
+		core: false,
+		plugin: "coder",
+		supportsChildren: true,
+		childLabel: "File",
+		defaultDepth: -1,
+		metaSchema: [{
+			type: "select",
+			key: "fileType",
+			options: [
+				"vue",
+				"ts",
+				"js",
+				"css",
+				"json",
+				"folder"
+			],
+			label: "Type"
+		}, {
+			type: "toggle",
+			key: "entry",
+			label: "Entry Point"
+		}]
+	}
+};
+const TYPE_ALIASES = { desktop: "dashboard" };
+function resolvePageType(key) {
+	if (!key) return void 0;
+	return PAGE_TYPES[TYPE_ALIASES[key] ?? key];
+}
+
+//#endregion
+//#region packages/cli/src/commands/page-types.ts
+/**
+* page-types / type-info commands: enumerate Abracadabra page types and their
+* metadata schemas. Works without a server connection — the catalog is static.
+*/
+function describeField(f) {
+	const bits = [];
+	bits.push(f.type);
+	if (f.key) bits.push(`key=${f.key}`);
+	if (f.latKey) bits.push(`latKey=${f.latKey},lngKey=${f.lngKey}`);
+	if (f.startKey) bits.push(`startKey=${f.startKey},endKey=${f.endKey}${f.allDayKey ? `,allDayKey=${f.allDayKey}` : ""}`);
+	if (f.options) bits.push(`options=[${f.options.join(", ")}]`);
+	if (f.presets) bits.push(`presets=${f.presets.length}`);
+	if (typeof f.min === "number" || typeof f.max === "number") bits.push(`range=${f.min ?? "?"}..${f.max ?? "?"}`);
+	if (f.step) bits.push(`step=${f.step}`);
+	if (f.unit) bits.push(`unit=${f.unit}`);
+	if (f.default !== void 0) bits.push(`default=${f.default}`);
+	return bits.join(" ");
+}
+registerCommand({
+	name: "page-types",
+	aliases: ["types", "doctypes"],
+	description: "List Abracadabra page types and their metadata schemas.",
+	usage: "page-types [key=<type>] [--format=json]",
+	async run(_conn, args) {
+		const key = args.params["key"] || args.params["type"] || args.positional[0];
+		const asJson = args.flags.has("json") || args.params["format"] === "json";
+		if (key) {
+			const info = resolvePageType(key);
+			if (!info) return `Unknown page type "${key}". Run 'abracadabra page-types' to list all.`;
+			if (asJson) return printJson(info);
+			const lines = [
+				`${info.label}  (${info.key})${info.core ? "" : `  [plugin: ${info.plugin}]`}`,
+				info.description ? `  ${info.description}` : "",
+				`  icon:              ${info.icon}`,
+				`  supportsChildren:  ${info.supportsChildren}`
+			];
+			if (info.childLabel) lines.push(`  childLabel:        ${info.childLabel}`);
+			if (info.grandchildLabel) lines.push(`  grandchildLabel:   ${info.grandchildLabel}`);
+			if (info.defaultDepth !== void 0) lines.push(`  defaultDepth:      ${info.defaultDepth === -1 ? "unlimited" : info.defaultDepth}`);
+			if (info.metaSchema?.length) {
+				lines.push("", `  metaSchema (applies to descendants):`);
+				for (const f of info.metaSchema) lines.push(`    - ${describeField(f)}${f.label ? `  "${f.label}"` : ""}`);
+			}
+			if (info.defaultMetaFields?.length) {
+				lines.push("", `  defaultMetaFields (renderer config on this doc):`);
+				for (const f of info.defaultMetaFields) lines.push(`    - ${describeField(f)}${f.label ? `  "${f.label}"` : ""}`);
+			}
+			return lines.filter(Boolean).join("\n");
+		}
+		const types = Object.values(PAGE_TYPES);
+		if (asJson) return printJson({
+			types,
+			aliases: TYPE_ALIASES
+		});
+		const coreTypes = types.filter((t) => t.core);
+		const pluginTypes = types.filter((t) => !t.core);
+		const lines = ["Core page types:"];
+		for (const t of coreTypes) {
+			const depth = t.defaultDepth === -1 ? "∞" : t.grandchildLabel ? "2" : t.supportsChildren ? "1" : "0";
+			const nesting = [t.childLabel, t.grandchildLabel].filter(Boolean).join(" → ");
+			lines.push(`  ${t.key.padEnd(12)}${(nesting || "—").padEnd(28)}depth=${depth}`);
+		}
+		lines.push("", "Plugin page types (require plugin):");
+		for (const t of pluginTypes) {
+			const depth = t.defaultDepth === -1 ? "∞" : t.grandchildLabel ? "2" : t.supportsChildren ? "1" : "0";
+			const nesting = [t.childLabel, t.grandchildLabel].filter(Boolean).join(" → ");
+			lines.push(`  ${t.key.padEnd(12)}${(nesting || "—").padEnd(28)}depth=${depth}  [plugin: ${t.plugin}]`);
+		}
+		lines.push("", "Aliases:");
+		for (const [from, to] of Object.entries(TYPE_ALIASES)) lines.push(`  ${from} → ${to}`);
+		lines.push("", `Run 'abracadabra page-types <key>' for field-level detail.`);
+		return lines.join("\n");
+	}
+});
+
 //#endregion
 //#region packages/cli/src/index.ts
 /**
@@ -3230,7 +4133,10 @@ const NO_CONNECT_COMMANDS = new Set([
 	"h",
 	"?",
 	"version",
-	"v"
+	"v",
+	"page-types",
+	"types",
+	"doctypes"
 ]);
 async function main() {
 	const args = parseArgs(process.argv);